Removes a rectangle from a window’s update region.

OSStatus ValidWindowRect (
    WindowRef window, 
    const Rect *bounds
);

window

A pointer to the window containing the rectangle that you wish to remove from being updated.

bounds

Set this structure to specify, in local coordinates, a rectangle to be removed from the window’s update region.

function result

A result code.

DISCUSSION

The ValidWindowRect function informs the Window Manager that an area of a window no longer needs to be redrawn. The ValidWindowRect function is similar to the ValidRect function, but ValidWindowRect allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so ValidWindowRect does not require the graphics port to be set before its use.

See also the functions InvalWindowRect and ValidWindowRgn.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)